
			 ______________________________________
			|_X_|         ______________________ |_|
			|       <>   |                      |  |
			|  /\   <>   | Car Radio by Clayman |  |
			|  \/   <>   |______________________|  |
			|       <>    |_|_|_|_|_|_|_|_|_|__|   |
			|______________________________________|


******************************


Titel: 	   ArmAII Car Radio

Author:    Clayman	<worldofclay@gmx.de>

Version:   2.3.1

Datum: 	   26.01.2011

Bentigt:  ArmA2 V1.05 oder hher UND Operation Arrowhead


******************************


Features:
 * Vollstrndig funktionierendes Autoradio fr alle PKW und LKW in ArmA2
 * Alle ArmA2 Musikstcke bereits enthalten
 * Beliebig viele eigene Musikstcke knnen hinzu gefgt werden
 * Filteroption zwischen InGame / eigener Musik
 * Repeat Funtkion
 * Zufallswiedergabe
 * 12-Farben Display
 * Bedienelemente in 7 Farben
 * Zwei Designs
 * Output Level abhngig von deiner Soundkarte / deinen Lautsprechern ;-)

Neu in V2.1:
 * Einbinden eigener Musik ist nun mglich
 * Zustzliche Fahrzeugtypen, fr die das Radio verfgbar ist
 * Playlist Editor
 * Haupt-Funktionen knnen direkt ber die Tastatur bedient werden

Neu in V2.2:
 * Drag & Drop Funktion fr Playlist Editor
 * Eigene Playlist kann vor-eingestellt werden (in userconfig .hpp)
 * Zustzliche Variablen mssen nicht mehr definiert werden, wenn nicht bentigt
 * Einzele Fahrzeugtypen, fr die das Radio nicht verfgbar ist, knnen definiert werden
 * Optionale Tooltips fr einige Bedienelemente

Neu in V2.3
 * Alle Musikstcke aus Operation Arrowhead in eigener Playlist hinzu gefgt
 * Fehlende Musikstcke aus Patch 1.05 (Eagle Wing) hinzu gefgt
 * Fehler behoben, dass einige Bedienelemente nach verlassen des Playlist Editors ber den Cancel Button nicht mehr funktionierten
 * Das Car Radio findet sich jetzt unter Module (F7) und hat ein eigenes Icon


******************************


Installation:
Die beiden enthaltenen Ordner '@CLAY_CarRadio' und 'userconfig' in deinen ArmAII Ordner entpacken.
In deiner ArmAII Verknpfung den Startparameter '-mod=@CLAY_CarRadio' hinzufgen.


******************************


Benutzung:
Um das Radio in deiner Mission verfgbar zu machen, einfach das 'Car Radio' Modul (zu finden unter Modulee > Car Radio) irgendwo auf der Map platzieren.
Das war's schon. 
Das Radio steht nun in jedem Auto (class "Car") zur Verfgung. Einfach einsteigen und im Aktionsmen "Car Radio" auswhlen.


******************************


Bedienung:
Einige Bedienelemente drften Selbsterklrend sein, andere vielleicht nicht. Hier eine kurze Auflistung:

 > - Startet die Wiedergabe (wechselt bei der Widergabe zu || )

 || - Beendet die Widergabe (wechselt zurck zu > )

 + - Lautstrke erhhen

 - - Lautstrke verringern

 >> - Nchster Titel

 << - Vorheriger Titel

 /\ - Filter aufsteigend durchschalten (ArmA2 Music > User Music > All Music > Custom)

 \/ - Filter absteigend durchschalten (ArmA2 Music > Custom > All Music > User Music)

 OFF - Beendet den Dialog (Musik luft weiter!)

 Playlist - ffnet den Playlist Editor

 Repeat - Sind alle Titel abgespielt, fngt die Widergabe von vorne an (ein / aus)('Repeat' erschein im Display)

 Random - Zufallswidergabe (ein / aus)('Random' erscheint im Display)

 Key Col - Schaltet die ("Beleuchtungs")Farben der Tasten durch

 Dspl Col - Schaltet die Farben des Displays durch oder schaltet auf automatischer Farbwechsel ('Col. Change' erscheint im Display)

 Design - Schaltet das Design um (Schwarz / "Silber")


******************************


Playlist Editor:
Mit dem Playlist Editor kannst du dir deine eigene Playliste zusammen stellen.
In der rechten Spalte findest du alle verfgbaren Tracks. Die linke Spalte stellt deine Playlist dar.

 < - Fgt den rechts ausgewhlten Track der Playlist (an letzter Stelle) hinzu

 > - Entfernt den link ausgewhlten Track aus der Playlist

 << - Fgt smtliche Tracks aus der rechten Spalte der Playlist hinzu

 >> - Entfernt alle Tracks aus der Playlist

 Restore - Stellt die (in der userconfig) vor-definierte Playlist wieder her (falls vorhanden)(Die manuell im Playlist Editor erstellte Playlist geht dabei verloren!)

 OK - Schliet den Playlist Editor und kehrt zum Radio zurck, welches deine zuvor erstellte Playlist wiedergibt

 Cancel - Schliet den Playlist Editor ohne die erstellte Playlist zu bernehmen, und kehrt zum Radio zurck


******************************


Tooltips anzeigen:
Es ist mglich, dass ber einigen der Bedienelemente des Radios Tooltips angezeigt werden, welche die Funktion des entsprechenden Elements erklrt.
Um diese Tooltips zu aktiviernen, schreibe den folgenden Code in die init.sqf oder die Init-Zeile einer beliebigen Einheit:


	CLAY_RadioShowTooltips = true;


******************************


Eigene Musik einbinden:
Um deine Eigene Musik im Radio verfgbar zu machen, musst due diese zunchst in der description.ext deiner Mission definieren.
Nun kannst du ber die Variable 'CLAY_RadioAddMusic' (z.B. in der init.sqf oder der Init-Zeile einer beliebigen Einheit) die Music in das Radio einbinden:


	CLAY_RadioAddMusic = [ [<Track | String>, <Title | String>, <Time | Number>] ];


Track = Der Classname deiner Musik wie du sie in der description.ext angegeben hast.

Title = Der Titel, so wie er im Radio angezeigt wird.

Time = Die Lnge des Tracks in Sekunden.


Fertig sieht das ganze dann in etwa so aus:


	CLAY_RadioAddMusic = [ ["MeinSong01", "Mein Song 1", 123], ["MeinSong02", "Mein Song 2", 456] ];


******************************


Vor-Definierte Playlist:
Du kannst deine eigene Playlist erstellen, die von Missionsstart an im Radio verfgbar ist (Playlist: Custom).
ffne dazu die Datei '\userconfig\CLAY_CarRadio\CLAY_CarRadio.hpp'. In das Array hinter _userPlaylist kannst du nun deine gewnschten Titel eintragen. Das Format dabei ist das selbe wie beim einfgen eigener Musik:


	_userPlaylist = [ ["Track08_Harvest_Red", "Harvest Red", 78], ["Track26_Organ_Works", "Organ Works", 69], ["MeinSong01", "Mein Song 1", 123] ];




******************************


Zustzliche Fahrzeugtypen:
Du kannst zustzliche Fahrzeugtypen definieren, in denen das Radio zur Verfgung stehen soll. Dazu musst du die Bezeichnungen der Fahrzeuge in der Variablen 'CLAY_RadioAddVehicles' eintragen.


	CLAY_RadioAddVehicles = ["M1A1", "AH1Z", "PBX"];


******************************


Fahrzeugtypen, die kein Radio haben sollen:
Ebenso wie du neue Fahrzeugtypen hinzu fgen kannst, kannst du auch einzelne Typen angeben, fr die das Radio nicht zur Verfgung stehen soll. Dazu wird die Variable 'CLAY_RadioNoVehicles' verwendet.


	CLAY_RadioNoVehicles = ["SkodaRed", "HMMWV", "TowingTractor"];


******************************


Tastaturbedienung:
Die Hauptfunktionen des Radios knnen direkt per Tastendruck bedient werden. Die Tasten fr jeden Funktion knnen frei gewhlt werden.

Standard Belegung:

 PAUSE - Play / Pause

 PFEIL RECHTS - Nchster Track

 PFEIL LINKS - Vorheriger Track

 PFEIL HOCH - Lautstrke erhhen

 PFEIL RUNTER - Lautstrke vermindern


Um diese Belegung zu ndern, ffne die Datei '\userconfig\CLAY_CarRadio\CLAY_CarRadio.hpp'.
Hinter die Variablen _keyPlay, _keyNext, _keyPre, _keyVolUp und _keyVolDown kannst du die entsprechende Tastennummer eintragen.


******************************


Bekannte Bugs:
 * Sehr schnelles Klicken auf die Vor- (>>) bzw. Zurck- (<<) Taste kann dazu fhren, dass die Zeitanzeige nicht mehr richtig funktioniert
 * Drag & Drop im Playlist Editor funktioniert nur, um Titel zu der Playlist hinzu zu fgen. Entfernen von Titeln oder nachtrgliches Sortieren ist so nicht mglich.


******************************


Weitere Informationen, Hilfe sowie eine Beispielmission, welche das einfgen eigener Musik und einbinden weiterer Fahrzeugtypen veranschaulicht, findest du unter folgenden Links:

	http://assaultmissionstudio.de/forum/viewthread.php?thread_id=297
	http://forums.bistudio.com/showthread.php?t=82665



Danke an:
BI fr ArmAII
Vektorbosen fr sein (OFP) Dialog Tutorial
T_D fr die Hilfe beim Display-Farbwechsel Script
kju fr die Untersttzung & ein paar sehr schne Ideen
Srgt_Foxhound, der mich "gentigt" hat dieses Update zu erstellen ;-)


Disclaimer:
Benutze dieses Addon auf eigene Gefahr! Ich bin nicht verantworlich fr smtliche (un)mglichen Schden, die dieses bei dir und/oder deinem Rechner / deiner Gesundheit / deiner Beziehung / deinem Leben anrichtet.


******************************


Change Log:

V2.3.1
 * 'nil' Fehler beseitigt

V2.3
 * Operation Arrowhead Tracks hinzu gefgt
 * Tracks aus der Eagle Wing Kampagne (ArmA2 Patch 1.05) hinzu gefgt
 * Bug bem verlassen des Playlist Editors ber den Cancel Button beseitigt
 * Car Radio unter Module (F7)
 * Eigenes Icon

V2.2
 * Alle Bugs aus Version 2.1 beseitigt
 * Drag & Drop Funktion fr Playlist Editor
 * Radio kann an beliebige Position auf dem Bildschirm verschoben werden
 * Eigene Playlist kann vordefiniert werden
 * Zustzliche Variablen mssen nicht mehr definiert werden, wenn nicht bentigt
 * Einzele Fahrzeugtypen, fr die das Radio nicht verfgbar ist
 * Tooltips fr einige Bedienelemente
 * Keine Verzgerung mehr beim klicken auf << oder >>
 * Fehler beim Display-Farbwechsel beseitigt
 * Einige kleinere Schnheitskorrekturen

V2.1.2
 * Musik spielt nach verlassen eines Fahrzeugs nun nicht mehr weiter

V2.1.1
 * Fehler beseitigt, der verhinderte, dass andere Musik abgespielt werden konnte

V2.1
 * Einbinden eigener Musik ist nun mglich
 * Zustzliche Fahrzeugklassen, fr die das Radio verfgbar ist, knnen definiert werden
 * Playlist Editor hinzu gefgt
 * Haupt-Funktionen knnen direkt ber die Tastatur bedient werden

V2.0
 * Portierung nach ArmAII
 * Alle Scripte neu aufgesetzt
 * Neues, deutlich verbessertes Design
 * Es knnen beliebig viele Musikstcke hinzu gefgt werden
 * Verschiedene Playlisten
 * Zufallswiedergabe Funktion
 * Automatischer Farbwechsel des Displays (flieender bergang)
 * Bedienelemente in 7 Farben


	(OFP Version)
V1.6:
 * 2 zwei verschiedene Farbdesigns
 * Einige kleine Bugs beseitigt

V1.5:
 * 12-farbiges Display
 * 3-farbige Bedienelemente

V1.4:
 * 5-farbiges Display
 * Alle globalen Variablen haben jetzt einen RADIO_ Tag

V1.3:
 * Hauptscript stark berarbeitet
 * Eigene Musik kann nun hinzu gefgt werden (bis zu 10 Tracks)
 * "Leuchtendes" Display

V1.2:
 * Zeit wird nun in Minuten und Sekunden angezeigt
 * Ein paar kleine Bugs beseitigt

V1.1:
 * Zeit und Lautstrke werden beim erneuten ffnen nun korrekt angezeigt
 * Bug beseitigt, der dazu fhrte, dass das Radio sich manchmal sofort nach dem ffnen wieder von selbst schloss

V1.0:
 * Bug beseitigt, der beim wechsel vom letzten Track in der Playlist zum ersten und anders herum auftrat
 * Alle Scripte in einen gesonderten Ordner verschoben

V0.99:
 * Erste BETA
 * Track Titel eird nach dem erneuten ffnen des Dialogs im Display angezeigt

V0.95:
 * Optimiertes Design
 * Musik spielt nun weiter, wenn der Dialog neu geffnet wird

V0.9:
 * Erste Version
